<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>copy_obj [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_object.html">Object</a> / <a href="toc_object_manipulation.html">Manipulation</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">copy_obj</span><span data-if="c" style="display:none;">copy_obj</span><span data-if="cpp" style="display:none;">CopyObj</span><span data-if="dotnet" style="display:none;">CopyObj</span><span data-if="python" style="display:none;">copy_obj</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">copy_obj</span><span data-if="c" style="display:none;">copy_obj</span><span data-if="cpp" style="display:none;">CopyObj</span><span data-if="dotnet" style="display:none;">CopyObj</span><span data-if="python" style="display:none;">copy_obj</span></code> — Copy an iconic object in the HALCON database.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>copy_obj</b>(<a href="#Objects"><i>Objects</i></a> : <a href="#ObjectsSelected"><i>ObjectsSelected</i></a> : <a href="#Index"><i>Index</i></a>, <a href="#NumObj"><i>NumObj</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>copy_obj</b>(const Hobject <a href="#Objects"><i>Objects</i></a>, Hobject* <a href="#ObjectsSelected"><i>ObjectsSelected</i></a>, const Hlong <a href="#Index"><i>Index</i></a>, const Hlong <a href="#NumObj"><i>NumObj</i></a>)</code></p>
<p>
<code>Herror <b>T_copy_obj</b>(const Hobject <a href="#Objects"><i>Objects</i></a>, Hobject* <a href="#ObjectsSelected"><i>ObjectsSelected</i></a>, const Htuple <a href="#Index"><i>Index</i></a>, const Htuple <a href="#NumObj"><i>NumObj</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>CopyObj</b>(const HObject&amp; <a href="#Objects"><i>Objects</i></a>, HObject* <a href="#ObjectsSelected"><i>ObjectsSelected</i></a>, const HTuple&amp; <a href="#Index"><i>Index</i></a>, const HTuple&amp; <a href="#NumObj"><i>NumObj</i></a>)</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HObject.html">HObject</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLD.html">HXLD</a> <a href="HXLD.html">HXLD</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLDCont.html">HXLDCont</a> <a href="HXLDCont.html">HXLDCont</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLDPoly.html">HXLDPoly</a> <a href="HXLDPoly.html">HXLDPoly</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLDPara.html">HXLDPara</a> <a href="HXLDPara.html">HXLDPara</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLDModPara.html">HXLDModPara</a> <a href="HXLDModPara.html">HXLDModPara</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
<p>
<code><a href="HXLDExtPara.html">HXLDExtPara</a> <a href="HXLDExtPara.html">HXLDExtPara</a>::<b>CopyObj</b>(Hlong <a href="#Index"><i>Index</i></a>, Hlong <a href="#NumObj"><i>NumObj</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>CopyObj</b>(<a href="HObject.html">HObject</a> <a href="#Objects"><i>objects</i></a>, out <a href="HObject.html">HObject</a> <a href="#ObjectsSelected"><i>objectsSelected</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Index"><i>index</i></a>, <a href="HTuple.html">HTuple</a> <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HObject.html">HObject</a> <a href="HObject.html">HObject</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HRegion.html">HRegion</a> <a href="HRegion.html">HRegion</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLD.html">HXLD</a> <a href="HXLD.html">HXLD</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLDCont.html">HXLDCont</a> <a href="HXLDCont.html">HXLDCont</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLDPoly.html">HXLDPoly</a> <a href="HXLDPoly.html">HXLDPoly</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLDPara.html">HXLDPara</a> <a href="HXLDPara.html">HXLDPara</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLDModPara.html">HXLDModPara</a> <a href="HXLDModPara.html">HXLDModPara</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
<p>
<code><a href="HXLDExtPara.html">HXLDExtPara</a> <a href="HXLDExtPara.html">HXLDExtPara</a>.<b>CopyObj</b>(int <a href="#Index"><i>index</i></a>, int <a href="#NumObj"><i>numObj</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>copy_obj</b>(<a href="#Objects"><i>objects</i></a>: HObject, <a href="#Index"><i>index</i></a>: int, <a href="#NumObj"><i>num_obj</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">copy_obj</span><span data-if="c" style="display:none">copy_obj</span><span data-if="cpp" style="display:none">CopyObj</span><span data-if="com" style="display:none">CopyObj</span><span data-if="dotnet" style="display:none">CopyObj</span><span data-if="python" style="display:none">copy_obj</span></code> copies <a href="#NumObj"><i><code><span data-if="hdevelop" style="display:inline">NumObj</span><span data-if="c" style="display:none">NumObj</span><span data-if="cpp" style="display:none">NumObj</span><span data-if="com" style="display:none">NumObj</span><span data-if="dotnet" style="display:none">numObj</span><span data-if="python" style="display:none">num_obj</span></code></i></a> iconic objects
beginning with index <a href="#Index"><i><code><span data-if="hdevelop" style="display:inline">Index</span><span data-if="c" style="display:none">Index</span><span data-if="cpp" style="display:none">Index</span><span data-if="com" style="display:none">Index</span><span data-if="dotnet" style="display:none">index</span><span data-if="python" style="display:none">index</span></code></i></a> (starting with 1) from the
iconic input object tuple <a href="#Objects"><i><code><span data-if="hdevelop" style="display:inline">Objects</span><span data-if="c" style="display:none">Objects</span><span data-if="cpp" style="display:none">Objects</span><span data-if="com" style="display:none">Objects</span><span data-if="dotnet" style="display:none">objects</span><span data-if="python" style="display:none">objects</span></code></i></a> to the output object
<a href="#ObjectsSelected"><i><code><span data-if="hdevelop" style="display:inline">ObjectsSelected</span><span data-if="c" style="display:none">ObjectsSelected</span><span data-if="cpp" style="display:none">ObjectsSelected</span><span data-if="com" style="display:none">ObjectsSelected</span><span data-if="dotnet" style="display:none">objectsSelected</span><span data-if="python" style="display:none">objects_selected</span></code></i></a>.  If -1 is passed for <a href="#NumObj"><i><code><span data-if="hdevelop" style="display:inline">NumObj</span><span data-if="c" style="display:none">NumObj</span><span data-if="cpp" style="display:none">NumObj</span><span data-if="com" style="display:none">NumObj</span><span data-if="dotnet" style="display:none">numObj</span><span data-if="python" style="display:none">num_obj</span></code></i></a>
all objects beginning with <a href="#Index"><i><code><span data-if="hdevelop" style="display:inline">Index</span><span data-if="c" style="display:none">Index</span><span data-if="cpp" style="display:none">Index</span><span data-if="com" style="display:none">Index</span><span data-if="dotnet" style="display:none">index</span><span data-if="python" style="display:none">index</span></code></i></a> are copied.  No new
storage is allocated for the regions and images.  Instead, new
objects containing references to the existing objects are created.
The number of objects in an object tuple can be queried with the
operator <a href="count_obj.html"><code><span data-if="hdevelop" style="display:inline">count_obj</span><span data-if="c" style="display:none">count_obj</span><span data-if="cpp" style="display:none">CountObj</span><span data-if="com" style="display:none">CountObj</span><span data-if="dotnet" style="display:none">CountObj</span><span data-if="python" style="display:none">count_obj</span></code></a>.
</p>
<p>For a short description of the iconic objects that are available in HALCON
see the introduction of chapter <a href="toc_object.html">Object</a>.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
    
      <li>Supports objects on compute devices.</li>
    
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Objects" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Objects</span><span data-if="c" style="display:none">Objects</span><span data-if="cpp" style="display:none">Objects</span><span data-if="com" style="display:none">Objects</span><span data-if="dotnet" style="display:none">objects</span><span data-if="python" style="display:none">objects</span></code></b> (input_object)  </span><span>object(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="c" style="display:none">Hobject</span></span>
</div>
<p class="pardesc">Objects to be copied.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ObjectsSelected" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ObjectsSelected</span><span data-if="c" style="display:none">ObjectsSelected</span><span data-if="cpp" style="display:none">ObjectsSelected</span><span data-if="com" style="display:none">ObjectsSelected</span><span data-if="dotnet" style="display:none">objectsSelected</span><span data-if="python" style="display:none">objects_selected</span></code></b> (output_object)  </span><span>object(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HObject.html">HObject</a></span><span data-if="c" style="display:none">Hobject *</span></span>
</div>
<p class="pardesc">Copied objects.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Index" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Index</span><span data-if="c" style="display:none">Index</span><span data-if="cpp" style="display:none">Index</span><span data-if="com" style="display:none">Index</span><span data-if="dotnet" style="display:none">index</span><span data-if="python" style="display:none">index</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Starting index of the objects to be copied.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Index</span>
    <span data-if="c" style="display:none">Index</span>
    <span data-if="cpp" style="display:none">Index</span>
    <span data-if="com" style="display:none">Index</span>
    <span data-if="dotnet" style="display:none">index</span>
    <span data-if="python" style="display:none">index</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>Index &lt;= number(Objects)</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="NumObj" class="parname"><b><code><span data-if="hdevelop" style="display:inline">NumObj</span><span data-if="c" style="display:none">NumObj</span><span data-if="cpp" style="display:none">NumObj</span><span data-if="com" style="display:none">NumObj</span><span data-if="dotnet" style="display:none">numObj</span><span data-if="python" style="display:none">num_obj</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Number of objects to be copied or -1.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>1</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>-1, 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>-1
          ≤
        
    <span data-if="hdevelop" style="display:inline">NumObj</span>
    <span data-if="c" style="display:none">NumObj</span>
    <span data-if="cpp" style="display:none">NumObj</span>
    <span data-if="com" style="display:none">NumObj</span>
    <span data-if="dotnet" style="display:none">numObj</span>
    <span data-if="python" style="display:none">num_obj</span>
    </code></p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>NumObj + Index - 1 &lt;= number(Objects) &amp;&amp; NumObj != 0</code></p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
/* Access all regions */

count_obj(Regions,&amp;Num);
for (i=1; i&lt;=Num; i++);
{
  copy_obj(Regions,&amp;Single,i,1);
  T_get_region_polygon(Single,5.0,&amp;Row,&amp;Column);
  T_disp_polygon(WindowHandleTuple,Row,Column);
  destroy_tuple(Row);
  destroy_tuple(Column);
}</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
gen_circle (Circles, [100,200,400], [200,100,400], [100,100,50])
copy_obj (Circles, CircleCopy, 2, 3)
erosion_circle (CircleCopy, CircleErosion, 15.5)
dev_set_color ('red')
dev_set_draw ('fill')
dev_display(Circles)
dev_set_color ('white')
dev_set_draw ('margin')
dev_display (CircleCopy)
dev_set_color ('green')
dev_display (CircleErosion)
</pre>
</div>
<h2 id="sec_complexity">Complexity</h2>
<p>Runtime complexity: O(|<a href="#Objects"><i><code><span data-if="hdevelop" style="display:inline">Objects</span><span data-if="c" style="display:none">Objects</span><span data-if="cpp" style="display:none">Objects</span><span data-if="com" style="display:none">Objects</span><span data-if="dotnet" style="display:none">objects</span><span data-if="python" style="display:none">objects</span></code></i></a>| + <a href="#NumObj"><i><code><span data-if="hdevelop" style="display:inline">NumObj</span><span data-if="c" style="display:none">NumObj</span><span data-if="cpp" style="display:none">NumObj</span><span data-if="com" style="display:none">NumObj</span><span data-if="dotnet" style="display:none">numObj</span><span data-if="python" style="display:none">num_obj</span></code></i></a>);
</p>
<p>Memory complexity of the result object: O(<a href="#NumObj"><i><code><span data-if="hdevelop" style="display:inline">NumObj</span><span data-if="c" style="display:none">NumObj</span><span data-if="cpp" style="display:none">NumObj</span><span data-if="com" style="display:none">NumObj</span><span data-if="dotnet" style="display:none">numObj</span><span data-if="python" style="display:none">num_obj</span></code></i></a>)</p>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">copy_obj</span><span data-if="c" style="display:none">copy_obj</span><span data-if="cpp" style="display:none">CopyObj</span><span data-if="com" style="display:none">CopyObj</span><span data-if="dotnet" style="display:none">CopyObj</span><span data-if="python" style="display:none">copy_obj</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all objects are contained in
the HALCON database and all parameters are correct.  If the input
is empty the behavior can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'no_object_result',&lt;Result&gt;:)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.
如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="count_obj.html"><span data-if="hdevelop" style="display:inline">count_obj</span><span data-if="c" style="display:none">count_obj</span><span data-if="cpp" style="display:none">CountObj</span><span data-if="com" style="display:none">CountObj</span><span data-if="dotnet" style="display:none">CountObj</span><span data-if="python" style="display:none">count_obj</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="select_obj.html"><span data-if="hdevelop" style="display:inline">select_obj</span><span data-if="c" style="display:none">select_obj</span><span data-if="cpp" style="display:none">SelectObj</span><span data-if="com" style="display:none">SelectObj</span><span data-if="dotnet" style="display:none">SelectObj</span><span data-if="python" style="display:none">select_obj</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="count_obj.html"><span data-if="hdevelop" style="display:inline">count_obj</span><span data-if="c" style="display:none">count_obj</span><span data-if="cpp" style="display:none">CountObj</span><span data-if="com" style="display:none">CountObj</span><span data-if="dotnet" style="display:none">CountObj</span><span data-if="python" style="display:none">count_obj</span></a></code>, 
<code><a href="concat_obj.html"><span data-if="hdevelop" style="display:inline">concat_obj</span><span data-if="c" style="display:none">concat_obj</span><span data-if="cpp" style="display:none">ConcatObj</span><span data-if="com" style="display:none">ConcatObj</span><span data-if="dotnet" style="display:none">ConcatObj</span><span data-if="python" style="display:none">concat_obj</span></a></code>, 
<code><a href="obj_to_integer.html"><span data-if="hdevelop" style="display:inline">obj_to_integer</span><span data-if="c" style="display:none">obj_to_integer</span><span data-if="cpp" style="display:none">ObjToInteger</span><span data-if="com" style="display:none">ObjToInteger</span><span data-if="dotnet" style="display:none">ObjToInteger</span><span data-if="python" style="display:none">obj_to_integer</span></a></code>, 
<code><a href="copy_image.html"><span data-if="hdevelop" style="display:inline">copy_image</span><span data-if="c" style="display:none">copy_image</span><span data-if="cpp" style="display:none">CopyImage</span><span data-if="com" style="display:none">CopyImage</span><span data-if="dotnet" style="display:none">CopyImage</span><span data-if="python" style="display:none">copy_image</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
